home *** CD-ROM | disk | FTP | other *** search
/ Mac Magazin/MacEasy 51 / Mac Magazin and MacEasy Magazine CD - Issue 51.iso / Software / Mobiles Büro / Sonstiges / Melody Pilot ƒ / Melody Pilot Help < prev    next >
Text File  |  1998-09-01  |  16KB  |  367 lines
  1.  
  2.                                    Melody Pilot Help
  3.  
  4. Introduction
  5.  
  6. Melody Pilot is a music composition program for creating melodies on
  7. the Macintosh that can also be played on PalmPilots.  Songs can be
  8. saved into and loaded from songbooks.  The same songbooks can be
  9. played on PalmPilots with Tan Kok Mun's Music Box
  10. (http://home.pacific.net.sg/~kokmun), which uses Ronald H. Nicholson Jr.'s
  11. cbasPad (http://www.nicholson.com/rhn/pilot.html).  Both of these excellent
  12. programs are freeware.
  13.  
  14. Minimum requirements for running Melody Pilot:
  15.     System 7.1 or later,
  16.     5 Mb of hard drive space, and
  17.     4 Mb free memory (2 Mb without color).
  18.  
  19.  
  20. Fields and Buttons
  21.  
  22.   Songbook Arrow Buttons - In the top, left corner of the window are
  23.     four buttons for moving to the first, previous, next, and last songs in
  24.     the songbook.
  25.  
  26.   Song Number - In the top right corner of the window are fields that
  27.     indicate the current song number and the total number of songs in the
  28.     songbook.
  29.  
  30.   Songbook Name - The name of the file containing the current songbook
  31.     is displayed at the top of the screen below the song number indicators.
  32.  
  33.   Title - Below the songbook name is the title of the song.  Each song
  34.     must have a title.  Melody Pilot will prompt you for a title when you
  35.     create a new song.  You can also edit the title by clicking on it.
  36.  
  37.   Score - The score isn't a real music score but a Music Box score.  This
  38.     field contains the notes, rests, tempo, and style changes that make up
  39.     the song.
  40.  
  41.   Keyboard - The main feature of Melody Pilot is a 75-key piano keyboard
  42.     at the bottom of the screen.  Clicking on the keys will play the
  43.     appropriate notes, which can be saved into a music "score" in Music
  44.     Box format (see "Save Notes in Score" below).  Note: the bottom 3 keys
  45.     play fine on the Mac but not on the PalmPilot (these keys are colored
  46.     gray and are marked with a black line).
  47.  
  48.   Lock - Clicking on this button locks the song to prevent accidental
  49.     changes once you are happy with the way a song sounds.  This
  50.     automatically turns off manual editing of the score and saving notes in
  51.     the score if those options are currently checked.  Clicking on the button
  52.     again unlocks the song.  The state of the lock is stored in the Music Box
  53.     score as the presence or absence of a space character at the end.
  54.  
  55.   Edit Score Manually - If you are familiar with Music Box format (see
  56.     Tan Kok Mun's documentation for details) you can edit the score
  57.     directly by checking this button.  While the score is being manually
  58.     edited, you cannot enter notes, rests, tempo changes, or style changes
  59.     using the buttons or shortcuts.  To stop editing, uncheck the Edit Score
  60.     Manually button.
  61.  
  62.   Save Notes in Score - If the "Save Notes in Score" checkbox is marked,
  63.     all keys that are played on the keyboard will also be saved in the Music
  64.     Box score with the duration specified by the duration, dot, and triplet
  65.     buttons.  If the checkbox is not marked, then notes will sound but will
  66.     not be saved.  This button applies to all songs in the songbook.
  67.  
  68.   Note Durations - Above the middle of the keyboard are buttons to set
  69.     the note duration.  From left to right these are whole note, half note,
  70.     quarter note, eighth note, sixteenth note, thirty-second note, and
  71.     sixty-fourth note.  Changing the note duration effects subsequent
  72.     notes saved to the score.
  73.  
  74.   Rests - Above the note duration buttons are the rest buttons.  From left
  75.     to right these are whole rest, half rest, quarter rest, eighth rest,
  76.     sixteenth rest, thirty-second rest, and sixty-fourth rest.  Clicking on
  77.     any of the rest buttons immediately inserts the appropriate rest into
  78.     the score.  If the "Dot" button is highlighted (see below) then a dotted
  79.     rest will be inserted.
  80.  
  81.   Dot - To the right of the note durations is a dot button.  This button is a
  82.     toggle that specifies whether notes and rests should be dotted,
  83.     meaning that their durations should be multiplied by one and a half
  84.     (e.g. a dotted half note is equivalent to a half note plus a quarter note).
  85.     If the dot button is highlighted then notes and rests will be dotted.
  86.     Otherwise they will have their normal durations.
  87.  
  88.   Triplet - To the right of the dot button is a triplet button.  This button is
  89.     a toggle that specifies whether notes and rests should be triplets,
  90.     meaning that their durations are two thirds as long as usual (three
  91.     triplet notes will take the same amount of time as two normal notes.
  92.     A triplet quarter note is equivalent to a "sixth" note).  Triplet whole
  93.     notes and sixty-fourth notes are not currently supported (Music Box
  94.     cannot understand them).  If the triplet button is highlighted then
  95.     notes and rests will be triplets.  Otherwise they will have their normal
  96.     durations.
  97.  
  98.   Clear (eraser icon) - To the right of the rest durations (above the dot
  99.     and triplet buttons) is a clear button.  Clicking on the eraser will delete
  100.     the last note, rest, style change, or tempo change from the score.
  101.  
  102.   Tempo - Melody Pilot will ask you for a tempo when you create a new
  103.     song as Music Box requires it.  The tempo is measured in beats per
  104.     minute (bpm), where a quarter note is equal to one beat. The minimum
  105.     tempo is 32 bpm and the maximum is 255 bpm (beware that faster
  106.     tempos may cause notes to slur together on slower Macs, although
  107.     they will play correctly in Music Box on the PalmPilot.  Some
  108.     instruments, like the flute, play better at fast tempos than others).
  109.     The default tempo is 120 bpm.
  110.  
  111.     You can change the tempo in three different ways: by dragging the
  112.     tempo slider (metronome icon), clicking on the decrease and increase
  113.     tempo arrow buttons, or clicking on the tempo itself.
  114.  
  115.   Sound - The "Sound" button pops up a menu that allows you to choose
  116.     between the available sounds to use when playing songs in Melody
  117.     Pilot.  The built in sounds are "flute", "Boing", and "Harpsichord".  This
  118.     button applies to all songs in the songbook but has no effect on the
  119.     sound in Music Box on the PalmPilot.  The default sound is "flute".
  120.  
  121.     You can install other sounds ("snd " resources) into Melody Pilot, but
  122.     instructions are beyond the scope of this help screen (if you are
  123.     familiar with ResEdit or other resource editors, it's a simple copy and
  124.     paste after which they will show up automatically).
  125.  
  126.   Play Song - The "Play Song" button (music notes icon) plays the current
  127.     song.  It is first translated to HyperCard music format, ignoring the
  128.     unsupported Style instructions.  You can interrupt play by clicking on
  129.     the same button, which will be labeled "Stop Music" during play
  130.     (actually, you can click anywhere in the window to stop play).
  131.  
  132.     If the "Edit Score Manually" button is checked and you have highlighted
  133.     a section of the score with the mouse, your selection will be played
  134.     instead of the entire score (note: if the selection does not start at the
  135.     beginning of the score, the note durations, octave, and tempo may not
  136.     be played accurately).
  137.  
  138.     If you hold the command () key while clicking on the "Play Song"
  139.     button, it will replay the last converted score or selection.  This will
  140.     save a little time if you have not made any changes to the score (this
  141.     works only with registered copies of Melody Pilot).
  142.  
  143.   Help Button - Above the keyboard on the left is a Help button (question
  144.     mark icon) that brings you to this screen.
  145.  
  146.  
  147.  
  148. Menus
  149.  
  150. The File menu contains items for creating, opening, and saving
  151. songbooks, for creating, reverting, and deleting songs, and for exiting
  152. Melody Pilot:
  153.  
  154.   New Songbook - This closes the current songbook and starts a new one.
  155.  
  156.   Open Songbook - This closes the current songbook and loads an
  157.     existing songbook from a file.
  158.  
  159.   Save Songbook - This saves the current songbook back to the file it
  160.     was originally loaded from.  This menu item will be disabled if this is a
  161.     new songbook.  Note that the state of the current songbook is kept
  162.     between invocations of Melody Pilot, and changes will not be lost until
  163.     a new songbook is loaded or created.  An empty songbook cannot be
  164.     saved.
  165.  
  166.   Save Songbook As... - This brings up a dialog box to save the current
  167.     songbook to a new file.  An empty songbook cannot be saved.
  168.  
  169.   New Song - This inserts a new song after the current song.  To insert a
  170.     song before the first song, invoke the New Song menu item from the
  171.     Help screen.
  172.  
  173.   Revert Song... - This reverts the score of the current song, if it has
  174.     been modified, to the last saved version after asking for confirmation.
  175.  
  176.   Delete Song... - This deletes the current song after asking for
  177.     confirmation.
  178.  
  179.   Quit Melody Pilot - Exits Melody Pilot.
  180.  
  181.  
  182. The Edit menu contains just the usual Macintosh editing commands.  The
  183. Undo command will undo the last change to the score.  A second Undo
  184. will redo whatever was just undone.  When editing the score manually,
  185. the Undo command applies to text editing commands.
  186.  
  187.  
  188. The first menu after the standard File and Edit menus is the Melody
  189. menu, which has three distinct sections.  The first section has options to
  190. copy the music score in two formats:
  191.  
  192.   Copy Music Box Score - This copies the score in Music Box format to
  193.     the clipboard where it can be pasted into a memo in the Pilot Desktop
  194.     application or into a file.
  195.  
  196.   Copy HyperCard Score - This copies the score in HyperCard format to
  197.     the clipboard where it can be pasted into another application,
  198.     HyperCard stack, etc.
  199.  
  200. In the second section of the Melody menu are items for transposing the
  201. current song up or down by a half step, whole step, or octave (these
  202. commands are enabled only in the registered version of Melody Pilot).
  203. The transposition is not allowed if it would put make any notes too low or
  204. high.
  205.  
  206.   Transpose Half Step Up - This transposes the current score up by 1
  207.     half step.  For example, a song in the key of C-major would be
  208.     transposed to the key of C#-major (a.k.a. D-flat major).
  209.  
  210.   Transpose Half Step Down - This transposes the current score down
  211.     by 1 half step.  For example, a song in the key of C-major would be
  212.     transposed to the key of B-major.
  213.  
  214.   Transpose Whole Step Up - This transposes the current score up by a
  215.     whole step (2 half steps).  For example, a song in the key of C-major
  216.     would be transposed to the key of D-major.
  217.  
  218.   Transpose Whole Step Down - This transposes the current score down
  219.     by a whole step (2 half steps).  For example, a song in the key of
  220.     C-major would be transposed to the key of A#-major (a.k.a. B-flat
  221.     major).
  222.  
  223.   Transpose Octave Up - This transposes the current score up by an
  224.     octave (12 half steps).
  225.  
  226.   Transpose Octave Down - This transposes the current score down by
  227.     an octave (12 half steps).
  228.  
  229. In the third section of the Melody menu are items for setting the music
  230. style (applicable only when playing songs using Music Box on the
  231. PalmPilot):
  232.  
  233.   Legato (Music Box) - Sets the Music Box play style to legato (notes
  234.     flow smoothly into one another).  This has no effect on how the music
  235.     is played on the Macintosh.
  236.  
  237.   Normal (Music Box) - Sets the Music Box play style to normal.  This
  238.     has no effect on how the music is played on the Macintosh.
  239.  
  240.   Staccato (Music Box) - Sets the Music Box play style to staccato
  241.     (notes are detached from one another).  This has no effect on how the
  242.     music is played on the Macintosh.
  243.  
  244.  
  245. To the right of the Melody menu is the Songs menu, which contains a list
  246. of all the songs in the current songbook.  Selecting any of the songs in
  247. this menu will bring you to that song.
  248.  
  249.  
  250.  
  251. Keyboard Shortcuts
  252.  
  253. The following keyboard shortcuts are available except when manually
  254. editing a score.
  255.  
  256.     <-N>                New Songbook
  257.     <-O>                Open Songbook
  258.     <-S>                 Save Songbook
  259.     <-M>               New Song
  260.     <CTRL-N>          New Song
  261.     <-?>                Go to this help screen
  262.     <-Z>                Undo last change
  263.  
  264.     {A-G}                 Play respective white key in octave 3*
  265.     {a-g}                 Play respective black key in octave 3*
  266.         * The following modifier keys change the octave in which these keys
  267.           will be played:
  268.         <CTRL>           Play key in octave 2
  269.         <OPTION>       Play key in octave 4
  270.         <CTRL-OPT>   Play key in octave 5
  271.  
  272.     1                         Set Duration to Whole Note
  273.     2                         Set Duration to Half Note
  274.     3                         Set Duration to Quarter Note
  275.     4                         Set Duration to Eighth Note
  276.     5                         Set Duration to Sixteenth Note
  277.     6                         Set Duration to Thirty-Second Note
  278.     7                         Set Duration to Sixty-Fourth Note
  279.  
  280.     ! (SHIFT-1)       Insert Whole Rest
  281.     @ (SHIFT-2)     Insert Half Rest
  282.     # (SHIFT-3)      Insert Quarter Rest
  283.     $ (SHIFT-4)      Insert Eighth Rest
  284.     % (SHIFT-5)     Insert Sixteenth Rest
  285.     ^ (SHIFT-6)      Insert Thirty-Second Rest
  286.     & (SHIFT-7)      Insert Sixty-Fourth Rest
  287.  
  288.     n                         New Song
  289.     p                         Play Song
  290.     s                         Toggle "Save Notes in Score" button
  291.     t                         Toggle "Triplet" button
  292.     .                          Toggle "Dot" button
  293.     <Backspace>    Clear last note, rest, style, or tempo mark from score
  294.     <Enter>             Play Song
  295.     <Return>           Play Song
  296.  
  297. Note: the <Home> key is equivalent to <CTRL-A>, and the <End> key is
  298. equivalent to <CTRL-D>.  Beware that if you are running a macro program
  299. such as QuicKeys or KeyQuencer that some of the above key mappings
  300. may be intercepted by the macro program first.
  301.  
  302.  
  303.  
  304. PalmPilot Download
  305.  
  306. Songbooks can be downloaded to your PalmPilot by importing them into
  307. the Memo pad in the Pilot Desktop application.  Run the Pilot Desktop
  308. program, go to the Memo Pad, and set the category that you want to
  309. use for your songs.  Select the Import... option from the File menu.
  310. Select the songbook you want to import, set the source character set to
  311. Macintosh, and click the Okay button.  Each of the songs in the
  312. songbook should now appear as a separate memo entry.
  313.  
  314. Individual songs can be also be downloaded by copying them from
  315. Melody Pilot score field using the Copy Music Box Score option of the
  316. Melody menu and pasting them into a Memo in the Pilot Desktop
  317. application.
  318.  
  319.  
  320.  
  321. Credits
  322.  
  323. Special thanks to the following people:
  324.  
  325.   Frédéric Rinaldi - for the FullResList XCMD (version 2.1, 1992) that is
  326.     used to get the list of sound resources, the CapsLock XFCN (version
  327.    1.0, 1990) that is used to test if the Caps Lock key is down, and the
  328.     SetFInfo XCMD (version 1.0, 1992) that is used to set the file type and
  329.     creator of saved files.  FullResList, CapsLock, and SetFInfo are
  330.     Copyright ©1989-1998 by F. Rinaldi.
  331.   R. Geisler - for the Balloon XCMD (version 1.0.1, 1992) that is used to
  332.     implement Balloon Help.
  333.   Ronald H. Nicholson Jr. - for the cbasPad BASIC interpreter.
  334.   Tan Kok Mun - for his excellent Music Box program.
  335.   The team at Apple - for HyperCard, which should have been the Mac
  336.     "killer app".
  337.   My parents - who are probably still wondering why they wasted all
  338.     their money on my piano lessons.
  339.  
  340.  
  341.  
  342. Registration and Contact Information
  343.  
  344. Melody Pilot
  345. Version 1.0.0 (September 1, 1998)
  346. Copyright ©1998 by Robert Jen (rjen@rjen.com)
  347. $5 Shareware
  348.  
  349. Please register through Kagi Software (http://order.kagi.com/?L9G&S)
  350. through the web or using the bundled Register Melody Pilot
  351. application.  You can also send checks to:
  352.  
  353.   Kagi
  354.   1442-A Walnut Street #392-L9G-M
  355.   Berkeley, CA 94079-1405
  356.  
  357. Once you have a registration code, click on the Register Now  button that
  358. appears when Melody Pilot first starts up.  Enter your name and
  359. registration code exactly as they appear on the registration email or
  360. postcard.  The registration screen will no longer appear on startup or
  361. afterward, and you will no longer be preventing from using the
  362. transposition option.
  363.  
  364. Bug reports, comments, and questions are welcome at rjen@rjen.com.
  365. The latest version of Melody Pilot, several songbooks, and other
  366. Macintosh and PalmPilot software and information can be found on
  367. the web at http://www.rjen.com.